home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / german / pkt / install.clx < prev    next >
Text File  |  1996-06-25  |  9KB  |  310 lines
  1. How to install the clx software on your system
  2.  
  3. The installation of the clx software requires some 
  4. knowledge of Linux and Unix in general. 
  5. It is not an easy task.
  6.  
  7. Here's a checklist for you:
  8.  
  9. I know how to use an editor (vi/emacs/joe)    [ ]
  10. I know how to add new users            [ ]
  11. I know about tar, zcat and gzip            [ ]
  12. I know about TCP/IP, networking, ping        [ ]
  13. I know about Syslogd                [ ]
  14. I know how to make a new Kernel            [ ]
  15. I know about Lilo or other boot loaders        [ ]
  16. I know how to add commands to /etc/rc.*        [ ]
  17. I know about crontab entries            [ ]
  18.  
  19. If you can say 'YES' to all of the above, you are
  20. prepared to install clx. If not, you better get yourself
  21. a book about Linux/Unix and play around with your system
  22. to become familiar. This may take some time (weeks,
  23. months).
  24.  
  25.  
  26. 1. Installing the package
  27.  
  28. Users in /etc/passwd
  29.  
  30. Clx needs two new users in your /etc/passwd.
  31.  
  32. These are:
  33.  
  34. User        Group    Home Directory
  35. ----------------------------------------------------
  36. clx         users    /usr/local/clx
  37. postgres     users    /usr/local/clx/postgres
  38. ----------------------------------------------------
  39.  
  40. It is a good idea to add them before you unpack the software.
  41. So the files will have correct ownership and permissions.
  42.  
  43. The clx software comes in one huge .tgz file. This file should
  44. be installed as follows:
  45.  
  46. # cd /
  47. # zcat clx_15.tgz | tar xvf -
  48.  
  49. This will unpack the clx software in the directory /usr/local/clx.
  50. You will need approximately 10 MB to install it.
  51.  
  52. You have now completed step one of the clx installation! Fine!
  53.  
  54.  
  55. 2. A new Kernel
  56.  
  57. You need a Linux kernel of version 1.1.73 or later with the following
  58. drivers/components:
  59.  
  60. - System V IPC
  61. - TCP/IP networking
  62. - Amateur Radio AX.25 Level 2
  63. - SLIP (serial line) support
  64.  
  65. Earlier or later kernel versions may or may not work. We are currently 
  66. using 1.1.73. 
  67.  
  68. To patch the kernel, grab the file ax25k027.tgz from the ~/ax25 directory,
  69. and apply it to your kernel sources:
  70.  
  71. # cd /
  72. # zcat ~clx_us/ax25/ax25k027.tgz | tar xvf -
  73.  
  74. Go to the /usr/src/linux directory and edit the config.in file.
  75. (with never kernel versions this file has wandered to the directory 
  76. /usr/src/linux/arch/i386/). Activate the line containing "Amateur Radio 
  77. AX.25 Level 2" by removing the leading '#'.
  78.  
  79. Now configure compile the new kernel with the following commands:
  80.  
  81. # cd /usr/src/linux
  82. # make config
  83.  
  84. You must include the components stated above. Now go ahead and make
  85. the new kernel. 
  86.  
  87. # make depend
  88. # make clean
  89. # make
  90.  
  91. Configure your boot loader (e.g. lilo) to use the newly created 
  92. kernel. 
  93.  
  94. Now boot the new kernel. Watch the boot messages. It should read 
  95. something like that:
  96.  
  97. ...
  98. Swansea University Computer Society NET3.016
  99. GW4PTS AX.25 for Linux. Version 0.23 ALPHA for Linux NET3.016 (Linux 1.1.19)
  100. Portions (c) Copyright 1984 University Of British Columbia
  101. Portions (c) Copyright 1990 The Regents of the University Of California
  102. NET3 TCP/IP protocols stack v016
  103. IP Protocols: ICMP, UDP, TCP
  104. SLIP: version 0.7.5-NET3.014-NEWTTY (4 channels)
  105. CSLIP: code copyright 1989 Regents of the University of California
  106. AX25: KISS encapsulation enabled
  107. ...
  108.  
  109. Congratulations! You have now finished the second step of the clx 
  110. installation procedure.
  111.  
  112.  
  113. 3. Testing the AX.25 driver
  114.  
  115. To check whether the newly created kernel driver is working
  116. we will make some tests.
  117.  
  118. First go to the /dev directory and make a soft link from
  119. the ttyS? where your TNC is connected to /dev/tnc:
  120.  
  121. # cd /dev
  122. # ln -s ttyS0 tnc
  123.  
  124. Switch your TNC into KISS mode. With my TNC2 clone running
  125. WA8DED firmware, I use the kisson shell script in ~clx_us/ax25 to 
  126. do that. The TNC should signal the transition to KISS mode by 
  127. flashing the CON and STA LEDs three times. After that you should 
  128. observe that the CON LED keeps flickering. This is a good sign!
  129.  
  130. Go to the ~clx/ax25 directory and start axattach manually.
  131.  
  132. # cd ~clx_us/ax25
  133. # ./axattach -s 9600 /dev/tnc DL6RAI-1 &
  134.  
  135. If you get the message "TIOCSETD: Invalid argument", you forgot 
  136. to add the the SLIP driver to the kernel.
  137.  
  138. Now start listen and you should be able to monitor some traffic on
  139. the channel:
  140.  
  141. # ./listen
  142. Port sl0: AX25: DB0MWS->DD5FK-1 <RR C P R5>
  143.  
  144. Port sl0: AX25: DB0MWS->DD5FK-1 <RR C P R5>
  145.  
  146. Port sl0: AX25: DB0MWS-9->DG7DAH v DB0MWS* <UI C> pid=IP
  147. IP: len 80 44.130.56.111->44.130.56.21 ihl 20 ttl 9 prot TCP
  148. TCP: 3600->1031 Seq x76e68c04 Ack x8a24c23a ACK PSH Wnd 1024 Data 40
  149. 0000  /..USER dh1sbm dd2fx 795521971 -1 0 Uwe.
  150.  
  151. Port sl0: AX25: DG7DAH->DB0MWS-9 v DB0MWS <UI C> pid=IP
  152. IP: len 40 44.130.56.21->44.130.56.111 ihl 20 ttl 9 prot TCP
  153. TCP: 1031->3600 Seq x8a24c23a Ack x76e68c2c ACK Wnd 1024
  154.  
  155. Interrupt it with ctrl-C. We can now try make a connect.
  156. This is dont with the call program. This program requires a
  157. configuration file /usr/local/ax25/etc/ports, where you
  158. have to spcify your callsign, speed, window size and frequency.
  159. Mine looks as follows:
  160.  
  161. DL6RAI-1 1200 4 438.325
  162.  
  163. call will not start without one. After you have edited this
  164. config file, you should be able to make a AX.25 connection:
  165.  
  166. # call db0mws
  167. GW4PTS AX.25 Connect v1.08
  168. Trying...
  169.  
  170. You should see your PTT LED go on and off and after a while
  171. you shoud succeed to connect.
  172.  
  173. Congratulations! You have now mastered step three of the clx 
  174. installation!
  175.  
  176.  
  177. 4. Configuring TCP/IP
  178.  
  179. Clx needs TCP/IP to communicate. Theoretically, it would be possible to
  180. have several modules of clx running on different machines as they are
  181. all using the same mechanism. 
  182.  
  183. All what it needed now is that you can reach yourself by TCP/IP. This
  184. is probably working already. Try the following command:
  185.  
  186. # ping localhost
  187.  
  188. If you receive the following, everything is in order and you can
  189. continue with the next step. Use ctrl-C to abort ping.
  190.  
  191. PING localhost (127.0.0.1): 56 data bytes
  192. 64 bytes from 127.0.0.1: icmp_seq=0 ttl=255 time=1 ms
  193. 64 bytes from 127.0.0.1: icmp_seq=1 ttl=255 time=1 ms
  194. ^C
  195. --- localhost ping statistics ---
  196. 2 packets transmitted, 2 packets received, 0% packet loss
  197. round-trip min/avg/max = 1/1/1 ms
  198.  
  199. However, if you get the following answer, something is not yet
  200. set up correctly.
  201.  
  202. PING localhost (127.0.0.1): 56 data bytes
  203. ping: sendto: Network is unreachable
  204. ping: wrote localhost 64 chars, ret=-1
  205. ^C
  206.  
  207. In one of the rc files in /etc or /etc/rc.d (depends on your 
  208. Linux installation) you must activate networking with the following 
  209. commands:
  210.  
  211.    ifconfig lo 127.0.0.1
  212.    route add localhost
  213.  
  214. See your Linux documentation for details.
  215.  
  216. You have now completed step four of the clx installation.
  217.  
  218. 5. Checking your configuration
  219.  
  220. Login as clx_us and go to the postgres directory to start
  221. postmaster.
  222.  
  223. $ cd postgres
  224. $ ./.pstart
  225.  
  226. Now go to the tools directory. There is a Perl script called
  227. check, which will check your installation. If the script
  228. fails, it usually tells you why it fails and what to do.
  229.  
  230. $ cd
  231. $ cd tools
  232. $ ./check
  233.  
  234. If the script finishes with the message
  235.  
  236.    Congratulations - clx should run on your system.
  237.  
  238. ... you are ready to run clx on your system.
  239.  
  240.  
  241. 6. Starting clx for the first time
  242.  
  243. We are now ready to start clx for the first time. Kill the axattach
  244. and postgres processes if they are still running and then login als 
  245. clx_us. You might have to edit the default config file in 
  246. ~clx_us/config/clx_par. Leave the callsign string as it is.
  247. You should check the tty and baud parameters.
  248.  
  249. Now start clx with the following command:
  250.  
  251. $ clx -u
  252.  
  253. You should now see clx coming up for the first time. 
  254.  
  255. *** CLX System Parameters ***
  256.  
  257. callsign:   xx0xx
  258. database:   clx_db
  259. tty:        /dev/tnc
  260. baudrate:   9600
  261.  
  262.  
  263. Checking directories and file permissions
  264. Clearing shared memories.
  265. Starting axattach.
  266. Starting postmaster.
  267. Clx coming up...
  268.  
  269. clx_ctl  Shared Memory manager            up
  270. int_com  Internal Communications Manager  up
  271. snd_ctl  Transmit Spooler                 up
  272. usr_ctl  User Administration              up
  273. iu_com   Inter-User communication         up
  274. icl_com  Inter-Node communication         up
  275. usr_req  User Database Interface          up
  276. mb_ctl   Mailbox Controller               up
  277. usc_mng  User Commands Manager            up
  278. rm_disp  Received messages Dispatcher     up
  279. rcv_ctl  Received messages Spooler        up
  280. con_ctl  AX.25 interface                  up
  281.  
  282. Clx is up.
  283. $
  284.  
  285. When clx is running, you will be returned to the $ prompt.
  286. You can now log into clx with the loc_usr program. Clx
  287. should greet you with a message and then display the
  288. clx> prompt. 
  289.  
  290. $ loc_usr
  291. Hi om, here is "clx"! Experimental cluster-software on linux.
  292. clx >
  293.  
  294. Now you can try a few commands, like
  295. 'sh/us', 'dx', 'sh/dx', 'set/name' etc. 
  296. Logout with 'bye'. 
  297.  
  298. Shutdown clx with the following commmand:
  299.  
  300. $ clx -s
  301.  
  302. Congratulations! You have sucessfully installed clx on your computer.
  303.  
  304. If you are now willing to run CLX on the air, read on!
  305. -----------------------------------------------------------------------------
  306. [] Bernhard Buettner (Ben)
  307. []      Mail: Am Brunnen 18, 85551 Kirchheim, Germany
  308. []  Internet: root@dl6rai.muc.de
  309. []    Packet: DL6RAI @ DB0AAB.#BAY.DEU.EU
  310.